QHIN (Kno2) - Integration
Setup guide
Prerequisites
- Before deploying this application, ensure that the necessary entitlements are added into your Health Cloud org to utilize the Salesforce Healthcare APIs.
- This asset leverages the Salesforce Healthcare APIs to synchronize patient demographics from a document retrieved from a responding provider organization via Kno2.
Dependent Applications
This solution leverages the following applications:
- Generic FHIR Client to connect with an EHR system. It can be configured to use JSON Web Token (JWT) or Client Credentials as the authorization protocol (will vary depending on the supported protocols by the EHR system).
- Salesforce Healthcare API Administration module to ingest Patient demographics into Salesforce Health Cloud.
- Kno2 System API to invoke the APIs provided by Kno2.
- C-CDA to FHIR System API to convert the C-CDA documents to FHIR.
- Patient Summary - EMR integration application to verify if the patient exists and onboard to EHR system.
Note: The fields that need to be populated vary for Generic FHIR Client Application based on choice of EMR system, so configure accordingly. C-CDA to FHIR System API do not need any specific fields to be configure and choose the None
option.
Anypoint Runtime Manager configuration
This solution requires manual configurations to few of the applications.
Below are the the steps to configure Patient Summary - EMR integration
application.
- Search the application using the
Search Applications
option and enterhls-hc-fhir-r4-sync-prc-api
as name to search. - Click on the Application, then click on the
Settings
on the left menu. A screen appears with multiple tabs to configure the application. - Click on the
Runtime
tab to configure theWorker size
as a minimum of1 vCore
. - Click on the
Properties
tab to configure/override the properties andApply Changes
to restart.
Required property overrides
At a minimum, the following properties must be configured to reflect the target deployment environment.
Property Name | Description |
---|---|
sys.emr.host | Host of the Generic FHIR Client System API instance |
sys.emr.clientid | Client Id of the Generic FHIR Client System API instance |
secure::sys.emr.clientsecret | Client Secret of the Generic FHIR Client System API instance |
Below are the the steps to configure Generic FHIR Client
application.
- Search the application using the
Search Applications
option and entergeneric-system-app
as name to search. - Click on the Application, then click on the
Settings
on the left menu. A screen appears with multiple tabs to configure the application. - Click on the
Properties
tab to configure/override the properties andApply Changes
to restart.
Required property overrides
At a minimum, the following properties must be configured to reflect the target deployment environment.
Property Name | Description |
---|---|
scope | List of scopes seperated with a space that are supported by the EHR system that is being configured. Look at the documemntation of the EHR System for supported scopes. For example - Cerner supports the following scopes and they can be configured as values to this property as shown: system/Patient.read system/Patient.write system/Practitioner.read system/Practitioner.write |
Salesforce Configurations
This solution also requires installation and configuration of custom component that invokes the Mule APIs deployed. Refer to Patient Sync Lightning Web Component.